home *** CD-ROM | disk | FTP | other *** search
/ Amiga CD-Sensation: Demos Are Forever / Amiga CD-Sensation - Ausgabe 1 - Demos Are Forever (1996)(GTI - Schatztruhe)(DE)[!].iso / Big Bunch / The Rest / Starfields / ES.doc < prev    next >
Text File  |  1992-05-17  |  4KB  |  114 lines
  1. ES                                                                         ES
  2.  
  3.    NAME
  4.     ES -- EuroStars
  5.  
  6.    SYNOPSIS
  7.     ES [MRS][XYZ] <value> [<value> ... ]
  8.     ES B
  9.     ES Q    (ARexx only)
  10.  
  11.    DESCRIPTION
  12.     ES is a starfield program based on European code that has been
  13.     massively cleaned up and featurized.  As a result, it doesn't run
  14.     quite as smoothly on vanilla 68000-based systems, but it's less
  15.     likely to trash your system.
  16.  
  17.     ES may be run from the command line or from the Workbench.  When
  18.     you're finished looking, click the left mouse button anywhere on the
  19.     starfield to exit.
  20.  
  21.     ES lets you specify how the stars move and rotate.  This is done
  22.     from the command line or from the ARexx port.  For both, the
  23.     argument syntax is the same.
  24.  
  25.    ARGUMENTS
  26.     The M, R, and S operators specify star movement, rotation, and spin
  27.     respectively.  Movement specifies how many world units the stars are
  28.     translated each frame.  Rotation specifies a static/initial rotation
  29.     angle.  Spin specifies the change in rotation for each frame.  The
  30.     X, Y, and Z specifiers indicate which axes the operators are to
  31.     apply.  Rotation angles are specified in "EuroHackerGrads."  There
  32.     are 2048 EHG to a full 360 degree circle.
  33.  
  34.     The MRS operators must appear before the the XYZ specifiers, and
  35.     there may be no spaces between them.  Only one MRS operator may
  36.     appear before a given set of XYZ specifiers.  Following the MRSXYZ
  37.     command are the actual values to be used.
  38.  
  39.     It's much easier to understand if you look at the examples.
  40.  
  41.     In addition to the above, there are two additional arguments that
  42.     may be used:
  43.  
  44.     B:    Operate as background server.
  45.         Ordinarily, ES will exit when you click on its screen.
  46.         However, if you want to do extensive ARexx operations
  47.         without user interference, this option may be specified,
  48.         causing ES to ignore all subsequent mouse events on its
  49.         screen.  Once backgrounded, ES cannot be un-backgrounded.
  50.         The only way to terminate a backgrounded ES is with the
  51.         following command:
  52.  
  53.     Q:    Quit.
  54.         When sent as an ARexx command, ES will exit immediately.
  55.         This option on the CLI command line is meaningless; if
  56.         present, the entire command line is ignored.
  57.  
  58.    AREXX
  59.     ES features an ARexx port.  The name of the port is EUROSTARS.
  60.     Commands sent to this port are exactly the same as those on the
  61.     command line.  Malformed commands are returned with RC set to
  62.     RC_ERROR (10).
  63.  
  64.     Commands are cumulative; that is, a move command (for example)
  65.     remains in effect until reset by another move command for the same
  66.     axis.  Thus, an MX command followed later by an SX command does not
  67.     cancel the MX command.
  68.  
  69.    EXAMPLES
  70.     ES mx 4
  71.         Move stars 4 units along X axis each frame.
  72.     ES sxyz 2 -4 6
  73.         For each frame, spin the X axis 2 EHG, the Y axis -4 EHG,
  74.         and the Z axis 6 EHG.
  75.     ES rx 512
  76.         Rotate X axis 512 EHG and keep it there.
  77.     ES rx -512 sx 2
  78.         Start X axis rotated at -512 EHG and add 2 EHG to it each
  79.         frame.
  80.     ES mxz 10 0 sxyz 2 2 2
  81.         Move 10 units along X, zero units along Z, and spin all axes
  82.         by two EHG each frame.
  83.     ES mxz sxyz 10 0 2 2 2
  84.         Identical to the above.
  85.     ES sxmxsymzsz 2 10 2 0 2
  86.         Again, identical to the above.
  87.  
  88.     As you can see, the syntax is very flexible.
  89.  
  90.    NOTES
  91.     Despite its nomenclature, the 'B' option does not fork ES into the
  92.     background; you must use the 'Run' command.
  93.  
  94.     The coordinate system is right-handed, X axis horizontal, Y axis
  95.     vertical, Z axis perpendicular to the screen.  Positive rotations
  96.     are clockwise, and are in Z,Y,X order.
  97.  
  98.     The default startup values are:
  99.     MX 0  MY 0  MZ 4   RX 0  RY 0  RZ 0   SX 0  SY 0  SZ 0
  100.  
  101.    BUGS
  102.     Slow on a 68000.  Short of Disable()ing the system or reducing the
  103.     number of stars, this is unavoidable.
  104.  
  105.     Malformed commands generate a diagnostic string to the CLI.  These
  106.     strings are not available to ARexx programs.  Sigh...
  107.  
  108.    AUTHOR
  109.     Leo L. Schwab  --  New Technologies Group, Inc.
  110.     BIX:        ewhac
  111.     Portal:        ewhac
  112.     InterNet:    ewhac@ntg.com   ..or..   ewhac@well.sf.ca.us
  113.  
  114.